home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / compresn / hv11 / hiview.doc < prev    next >
Encoding:
Text File  |  1992-07-07  |  7.2 KB  |  167 lines
  1.  
  2.  
  3.  
  4.  
  5.                                Hiview/Jview 1.1
  6.                        A JPEG/GIF/TGA File Viewer
  7.                          By Mohammad A. REZAEI
  8.                       rezaei@upenn5.hep.upenn.edu
  9.                          
  10.  
  11. INTRODUCTION
  12.         Hiview is a freeware JPEG/GIF/TGA file viewer for video cards
  13. with the TSENG 4000, ATI, and TRIDENT 8900 chipsets. The Hicolor mode on
  14. TSENG cards is supported. The viewer centers the image and scales it down
  15. to fit the screen, if necessary.
  16.         Jview is the same program compiled with the older graphics drivers
  17. so it can handle AHEADA/B, Chips&Tech, Everex, Genoa, Oak, Paradise,
  18. Tseng 3000, and Video 7 video cards.
  19.  
  20. Please note that only the following modes will be used (only these 
  21. have square pixels!):
  22.  
  23.         640x480x256
  24.         800x600x256
  25.         1024x768x256
  26.         640x480x32k (Tseng 4000 only)
  27.         800x600x32k (Tseng 4000 only)
  28.         
  29. The hicolor modes are much faster and you can see something happening
  30. all the time. The 256 color modes must go through a quantization step
  31. where the screen is blanked and nothing is displayed.
  32.  
  33. REQUIREMENTS
  34.         o 386 computer.
  35.         o A video card with one the following chipsets mentioned above.
  36.         o VCPI environemnt 
  37.                 (i.e., the code won't work under MS Windows or OS/2)
  38.  
  39. If you would like to compile the code yourself, you will additionally require:
  40.         o djgpp (actually no C++ extensions necessary)
  41.         o Source code from version 3 of the Independent JPEG group
  42.         o The LIBGRX extensions to djgpp.
  43. The JPEG source is available in many archives (wuacrvhie.wustl.edu,
  44. simtel, etc.). djgpp and LIBGRX are available from barnacle.erc.clarkson.edu.
  45.  
  46. COPYRIGHTS AND SUCH
  47.         The source code for the viewer is included with the distribution.
  48. I have written most of the code in viewer.c, which is based on example.c of
  49. the JPEG distribution. This code is distributed with the same intentions and
  50. policies as the Independent JPEG group software. However, please note the
  51. copyrights and distribution policies of the portion of the code that is
  52. from any other source. This includes the djgpp stuff (the prepended
  53. go32 to hiview.exe, the 387 emulator), the LIBGRX drivers and the JPEG
  54. files distributed with the code. So please read COPYING and COPYING.DJ,
  55. COPYING.GRX and README.IJG.
  56.  
  57. DESIGN INTENTIONS
  58.         The code is intended to be as fast as possible with a user
  59. friendly interface and lots of options. Admitedly, the code is rather
  60. ugly in this initial release.        
  61.  
  62.         I strongly encourage additions and modifications to my code.
  63. However, to keep the distribution uniform, I would like to be the sole
  64. distributor of the viewer "hiview". So please send me your suggestions, and
  65. modifications. I can be reached as rezaei@upenn5.hep.upenn.edu until
  66. August 15, 1992. (I will have a different address after that.) If you intend
  67. to do any modifications, please read todo.doc.
  68.  
  69. SETUP FOR THE VIEWER
  70.         As the code is compiled with djgcc, you need to set two environment
  71. variables: GO32 and GO32TMP. GO32 lets go32 (the dj extender) know what 
  72. graphics driver to use, and GO32TMP is the place you would like the
  73. temporary files to go (go32 swap directory). PLEASE NOTE: all directory
  74. slashes must be forward slashes (ala UNIX) not back slashes.
  75. For example, my settings are:
  76.  
  77. SET GO32TMP=c:/tmp
  78. SET GO32=ansi driver c:/djgcc/contrib/libgrx/drivers/et4000.grn
  79.  
  80. If you don't setup these variables properly, the code will crash and burn!
  81. In addition, if you don't have a 387, you need to add
  82.  
  83. emu <emu387 location>
  84. to the GO32 environment variable,
  85. where <emu387 location> is where you put the emu387 file.
  86.  
  87. After this setup, you can run hiview. It will look in the current directory
  88. for files matching *.jpg, *.gif and *.tga.
  89.  
  90. COMMAND LINE OPTIONS
  91.         With no command line options, hiview will look in the current directory
  92. for files matching *.jpg, *.gif and *.tga.
  93. You can include file specifications on the command line. The viewer expects
  94. that the file extension specify the file type, but you can override this with
  95. the -j, -g and -t flags for JPEG, GIF and TARGA respectively.
  96. So, if for some reason you have a file called "pic.jpg" which is actually
  97. a GIF file, you can view it with "hiview -g pic.jpg".
  98. Please note that any file specification appearing after these flags will
  99. be expected to be of that type, so "hiview -g pic1.gif pic2.tga" will think
  100. pic2.tga is a GIF file. To get the correct result, you can use
  101. "hiview pic2.tga -g pic1.gif" or "hiview -g pic1.gif -t pic2.tga".
  102.  
  103. The following flags toggle the desired effect:
  104.  
  105. -h Hicolor mode, default is on.
  106. -b Block smoothing, default is off.
  107. -p Pixel smoothing, default is off.
  108. -s <gamma> Gamma specification, default is 1.0, values between 0.1 and 2.0
  109.         are usually used.
  110. -i Linear interpolation, default is on. (24->15 bit only)
  111.         This helps alot if the scaling ratio (image/screen) is between
  112.         1 and 2. It doesn't help much if scaling ratio is above 2
  113. -d Floyd-Steinberg dithering, default is off. (24->15 bit only)
  114.         Helps significantly with some images with smooth shaded regions.
  115. -q 24->8 bit quatization, one pass or two pass, default is one pass.
  116.  
  117. All the above can be changed interactively from the menus.
  118.  
  119. USING HIVIEW INTERACTIVELY
  120.         Once the filenames are displayed, you can use the arrow keys
  121. to choose the file to be displayed. Pressing "O" gets you to the options
  122. menu.
  123.        
  124.  
  125. BUGS AND LIMITATIONS
  126.         The viewer can't deal with a directory as a command line parameter.
  127. It can however deal with wildcards, so "hiview \pics" won't work, whereas
  128. "hiview \pics\*.jpg" will. Same is true for drive names: "hiview a:" is
  129. not supported, but "hiview a:*.*" is.
  130.  
  131.         The viewer cannot handle files larger than 4096x4096, but this
  132. can be easily changed by recompiling.
  133.         
  134.         You cannot display TARGA files in 8 bit mode (yet). Trying this
  135. will result in strange behaviour.
  136.  
  137.         Colormaped TARGA files are not supported.
  138.         
  139.         There seems to be some minor bugs with the 24->8 bit two pass 
  140. quantization in the jpeg source. The only time I've come across this is 
  141. in a file called corinna1.jpg, a rather large jpeg file. I have reported
  142. this to Tom Lane.
  143.         
  144.         The ATI and TRIDENT modes are untested.
  145.  
  146.         Please see the todo.doc file for planned solutions to the above and
  147. improvements to be incorporated into the next release of the program.        
  148.         
  149.  
  150.  
  151. HISTORY
  152.  
  153. 7/6/92 version 1.0, initial release. Special thanks go to Bruce (bs@mda.ca)
  154. 7/7/92 version 1.1, now two executables, hiview.exe and jview.exe exist
  155.         hiview handles Tseng 4000, Ati and Trident 8900 chipsets.
  156.         jview handles the rest. Eventually, only hiview should exist.
  157.         On setups with no 387, there should be a significant speedup.        
  158.         modified files: makefile.*
  159.                         viewer.h
  160.                         viewer.c
  161.                         hiview.exe
  162.                         hiview.doc
  163.                         todo.doc
  164.         new files:      jview.exe
  165.                         *.grd (old graphics drivers)
  166.                         src/mkjview.lst
  167.